home *** CD-ROM | disk | FTP | other *** search
/ Internet Publisher's Toolbox 2.0 / Internet Publisher's Toolbox.iso / internet / email / pegasus / wguide.exe (.txt) < prev    next >
Encoding:
David's Readme Compiler Executable  |  1994-09-12  |  109.8 KB  |  1,465 lines

  1. xdYY=
  2. 6YY_^
  3. l4YY_^
  4. H9D0}
  5.  ; A B D G H I K M O P Q R S s t u v 
  6. KvY_^]
  7.  YYG;>
  8.  A B D
  9. ymY_^
  10. <Ar    ,@
  11. _^_^]
  12.  H I K M P Q
  13.  H I QA5)5
  14. 5 5-5/5U
  15. YYF;v
  16. ;Dz~    
  17. :>;>;4;
  18. ;>;K;-;U
  19. ?DYPV
  20.  H I K M P Q3A
  21. DF_^]
  22. YY9|,uK
  23. ;D@ui
  24. ;DDu2
  25. H9D0~
  26. 9D<|    u
  27. .Y;D2v
  28. H9D0u
  29. YY_^]
  30. YY_^]
  31. ~-YY3
  32. ,Y)D:
  33. C+Y;F
  34. f)Y;D2wK
  35. {^.97t
  36.  G H I K M O P Q R S s t u wri8j8j
  37. i8j8j
  38. i8j8j+j
  39. h^i(iU
  40. t0Nt-
  41. !r.RP
  42. !r$RP
  43. u/SQR
  44. [[XP3
  45. Turbo C++ - Copyright 1990 Borland Intl.
  46. Null pointer assignment
  47. Divide error
  48. Abnormal program termination
  49. $    ~ p 
  50. Courier
  51. Do you want to overwrite
  52. File exists
  53.  Print Settings 
  54.  - Printing -
  55.  Save as what file? 
  56. Failed saving to file!
  57.  Failed! 
  58.  PgUp/Dn: 
  59. <F10>
  60.  options
  61.  PgUp/Dn
  62.  Line %d of %d 
  63.  Search for 
  64.  Topics 
  65.  --- Searching --- 
  66. No matching entries found.
  67. ind text   <F7>
  68. find 
  69. gain  <F8>
  70. rint entry     
  71. ave entry      
  72. dit entry      
  73. Printer port :
  74. PostScript?  :
  75. Press <Space> to change values
  76. Created using
  77. David's Readme Compiler v2.11
  78. (c) 1990-93, David Harris.
  79. e-mail: david@pmail.gen.nz
  80. LPT1:
  81. LPT2:
  82. LPT3:
  83. %!PS-Adobe-2.0
  84. %%Creator:DRC v2.0
  85. %%EndComments
  86. /leftmargin { 40 } bind def
  87. /bot { 54 } bind def /top { 
  88.  } bind def
  89. /cw { 40 } bind def
  90. /xtab
  91.  {currentpoint exch dup cvi
  92.  leftmargin cvi sub cvi
  93.  cw cvi mod sub
  94.  cw add
  95.  exch moveto
  96.  } bind def
  97. /ptsize { 12 } bind def /lead { 12 } bind def
  98. /F { findfont exch scalefont setfont } bind def
  99. /newline {
  100.  currentpoint exch pop lead sub
  101.  dup bot lt {
  102.   pop showpage restore save
  103.   top
  104.   } if
  105.  leftmargin exch moveto
  106.  } bind def
  107. %%Endprolog
  108. %%BeginSetup
  109. ptsize /| F
  110. leftmargin top moveto
  111. %%EndSetup
  112. %.20s (Y/N)? 
  113. %-50.50s
  114. newline
  115. ) show newline
  116. newline
  117. showpage restore
  118. David's Readme Compiler, (c) 1992, David Harris.
  119. Readme error: no attached data.
  120.  About this Guide 
  121. MMMODE
  122.  ; < = > ? @ A B C D T U V W X Y Z [ \ ]
  123.  G O w u R S s t
  124. EAEIIOOUUYIOU
  125. (press any key to continue)
  126. Insert paper in printer then press
  127. a key (<ESC> cancels print)
  128.  Printer error 
  129. The printer on LPT%d: is
  130. confused
  131. out of paper
  132. off line
  133. Correct then press a key
  134. or hit <ESC> to cancel print
  135.  Insert Paper 
  136. <ESC>
  137.  key pressed:
  138. Please confirm cancel/quit
  139. Accept this data?  
  140.  Insufficient disk space 
  141. There is not enough space on the target
  142. disk to receive the file(s): please replace
  143. the disk with another formatted disk, then
  144. press any key to retry, or <ESC> to cancel 
  145.  .,@:;
  146. 0123456789
  147.          !!!!!                  
  148. @@@@@@@@@@@@@@@
  149. @@@@@@@
  150. @@@@@@
  151. @@@@ 
  152. (null)
  153. Data file generated by RCOM.
  154.  Pegasus Mail for Windows version 1.2 (R2) guide
  155. Welcome to Pegasus Mail for Windows!
  156. Main screen status line
  157. Help on editing text
  158. IMPORTANT information
  159. Information about WinPMail
  160. What's new in WinPMail v1.2
  161. Installing WinPMail
  162. TCP/IP-based mail via WINSOCK
  163. Users groups and mail lists
  164. The PMAIL User's Group
  165. The PM-NEWS announcement list
  166. Other utilities supplied
  167. User-defined gateways
  168. Ordering WinPMail manuals
  169. About WinPMail 1.2
  170. Known limitations
  171. Using Tabs in the editor
  172. WinPMail and Mercury
  173. Special note for MHS users
  174. WinPMail and NetWare 4.0
  175. Revision history: v1.1
  176. WinPMail futures
  177. About Pegasus Mail
  178. Contacting the author
  179. Charon and Mercury
  180. Acknowledgments
  181. About this guide...
  182. Installing WinPMail
  183. Modifying NET$LOG.DAT
  184. Selecting a server at runtime
  185. Enabling extended options for users
  186. Enabling delivery between servers
  187. SMTP mail via Charon/Mercury
  188. NetWare MHS and WinPMail
  189. Altering character translation
  190. Setting up Noticeboards
  191. Control groups
  192. System-wide lists/books/folders
  193. Installing WinPMail for use with MHS
  194. User-settable MHS options
  195. Personal names and MHS
  196. Recommendations for installation
  197. How Pegasus Mail uses MHS
  198. Notes on this release
  199. PMGRANT.EXE
  200. MAILDIR.EXE
  201. PMSORT.EXE
  202. PREBUILD.EXE
  203. UNCONFIG.EXE
  204. WinPMail and WINSOCK
  205. Recommended implementations
  206. Installation notes
  207. Suppressing WINSOCK use
  208. WINSOCK Notes
  209. Manual Availability
  210. WinPMail Manuals
  211. Ordering manuals
  212. Payment by credit card
  213. Existing license holders
  214. Telegraphic Transfers
  215. Orders from Europe
  216. Terms and conditions
  217. WinPMail Manuals - Order Form
  218. This electronic guide contains all the information you need to
  219. install and use Pegasus Mail for Windows.
  220. Please read the section marked 
  221. Important
  222.  on the main menu - it
  223. contains information you MUST know before using this version
  224. of WinPMail.
  225. If you wish to order manuals, you can edit and print the order
  226. form from within this guide by pressing 
  227. <F10>
  228.  and selecting
  229.  while viewing the form.
  230. Full search capabilities are available in this guide at any time
  231. by pressing 
  232. , or selecting 
  233. Find text
  234.  from the <F10> menu.
  235. Please press 
  236. <Return>
  237.  to continue...
  238.        Pegasus Mail System, (c) 1990-94, David Harris, all rights reserved
  239.      Search, edit and print options available when reading by pressing <F10>
  240. While editing this form, you can move from field to field using
  241. <Tab>
  242.  key.
  243. Use the arrow and page keys to move around while editing. You can
  244. delete text using the 
  245. <Del>
  246.  and 
  247. <Bks>
  248.  keys, and 
  249. <Ctrl-Y>
  250.  will delete
  251. a line.
  252. You cannot alter the readme file from this screen, but you can save
  253. the screen (with any changes you make) to a text file by pressing
  254. <F10>
  255.  and selecting 
  256. . You can print this form at any time from
  257. the same menu.
  258. Any changes you make will be lost when you close this screen.
  259. Please press <Return> to continue...
  260. Version 1.22:
  261. Version 1.22 fixes the following problems -
  262. * Occasional folder corruption when messages were moved to a folder
  263.   already open on the desktop.
  264. * Occasional lost attachments when moving messages between folders.
  265. * PMDFLTS.INI is now properly read even when the user has already run
  266.   the DOS version of Pegasus Mail.
  267. * Problems with the built-in TCP/IP-based mail when the "load on
  268.   demand" flag was set have been fixed.
  269. It also adds two small new features -
  270. * When you add an address book entry while a message is open,
  271.   WinPMail now tries to fill out the new record with information from
  272.   the message, in much the way the DOS version does.
  273. * The address book entry editor now supports the "Recently-used
  274.   addresses" button found in the message editor window.
  275. Version 1.21:
  276. * Noticeboard support: the noticeboard feature introduced in Pegasus
  277.   Mail for DOS v3.11 has now been added to WinPMail. A new toolbar
  278.   icon is provided for quick access to it.
  279. * Floating distribution list manager. Now, when you want to use
  280.   distribution lists, you can open the Distribution List Window and
  281.   leave it on your desktop; distribution lists can now be pasted and
  282.   dragged/dropped like addresses from any other address list.
  283. * Address book import/export services, parallel to those in the DOS
  284.   version of Pegasus Mail (see the "Addressbook" menu while you have
  285.   an addressbook open).
  286. * A new "advanced preferences" menu entry in the preferences menu
  287.   lets you to configure advanced features in Pegasus Mail, including:
  288.   - how often WinPMail should scan your new mail box for new mail
  289.   - your organization and timezone for standalone TCP/IP users
  290.   - whether or not WinPMail should autoload WINSOCK.DLL at startup
  291.   - whether WinPMail should generate enclosures or attachments
  292. * Enclosure support: traditionally, Pegasus Mail has sent
  293.   attachments addressed to Internet addresses as separate messages.
  294.   There are many sound reasons for doing this, but most users seem to
  295.   find it unintuitive. To get around this, you can now tell Pegasus
  296.   Mail to generate enclosures instead of attachments. When generating
  297.   "enclosures", Pegasus Mail simply encodes the attachment onto the
  298.   end of the message, so only a single message is sent out: if MIME
  299.   encoding is chosen, Pegasus Mail puts the message and attachments
  300.   into a single multipart MIME message. Pegasus Mail also now deals
  301.   with incoming enclosures much more effectively than previous
  302.   versions. >> Enclosures are enabled in the "Advanced settings"
  303.   prefences dialog.
  304. * Textual INI file for preferences: previous versions of Pegasus
  305.   Mail used a binary file called WINPMAIL.PRO to store the user's
  306.   preferences and settings. Starting with WinPMail 1.2 and Pegasus
  307.   Mail/DOS v3.20, a new textual format is provided which is used by
  308.   both versions of the program. Highly readable, the new format
  309.   allows many aspects of the user's preferences to be shared between
  310.   versions, something which has not previously been possible. The new
  311.   format also provides near-total control over a user's default
  312.   settings: by writing or copying an INI file into the same directory
  313.   as WINPMAIL.EXE using the name PMDFLTS.INI, the system supervisor
  314.   can provide default settings for almost every aspect of the
  315.   program's operation, right down to window positions. The INI format
  316.   also includes useful diagnostic sections generated by the programs
  317.   which can be helpful in tracking down configuration errors.
  318. * The "Prompt for copy-to-self" and "Prompt for copy-to-self folder"
  319.   options available in the DOS version are now also available in
  320.   WinPMail. These settings are "sticky" and can be set in the
  321.   "Special" view of the message editor.
  322. * Cosmetic enhancements: users should notice quite a number of
  323.   cosmetic improvements to the program, including separating rules in
  324.   most windows, improved bitmaps, and a visual clarification of the
  325.   function of the "editor", "attachment" and "special" buttons in the
  326.   message editor.
  327. * Annotations: add comments to mail messages (see the "Reader" menu
  328.   while you are reading a message).
  329. * A "telltale" window, which appears while WinPMail is minimized.
  330.   The telltale reports the number of new messages in your mail
  331.   folder, and changes to red if new mail has arrived. It can be
  332.   positioned anywhere on your desktop and can be made to appear
  333.   "always on top" by checking the control for this in the "Advanced
  334.   preferences" dialog. The telltale window has three modes, which can
  335.   be selected by clicking on it. The first simply reports the total
  336.   number of messages in the new mail folder. The second reports how
  337.   many messages have arrived since WinPMail was minimized, and the
  338.   third reports a "summary" of the contents of your new mail folder.
  339. * Considerably improved TCP/IP mail services, including:
  340.   - The ability to define the address Pegasus Mail should use in
  341.     the From: field of outgoing mail.
  342.   - More control over TCP/IP timeout values
  343.   - More robust TCP/IP protocol handling
  344.   - Periodic and idle-time checking of the POP3 host for new mail
  345.   - You can now leave your POP3 password blank and Pegasus Mail
  346.     will prompt you for it at startup.
  347.   - You can now force all mail through the internal transport.
  348. * Statusline help; help messages now appear on the status line as
  349.   you scroll through menu selections.
  350. * You can now drag files from the file manager and drop them onto
  351.   WinPMail; it will attach the files you drop to the last message
  352.   you were editing, or if none, will start a new message and
  353.   attach them to that.
  354. * External interface routines: it is now possible to override
  355.   certain of Pegasus Mail's system-level functions with your own
  356.   routines - in particular, you can now override Pegasus Mail's
  357.   default behaviour for
  358.      1: finding the username of the user at the current station
  359.      2: finding the path to the user's new mail directory
  360.      3: finding the directory in which Pegasus Mail should write
  361.         outgoing mail messages.
  362.   This change is a prelude to providing full support for NetWare
  363.   4.0x and 4.1 in Pegasus Mail and should also make it possible to
  364.   make Pegasus Mail "network-aware" on other LAN architectures as
  365.   well. A useful side-effect is the possibility of having all mail
  366.   stored on a volume other than SYS: under NetWare 3.x and earlier.
  367.   For more information on this change, see the file PMIF.TXT supplied
  368.   with this release.
  369. * Innumerable bug fixes; the following are the most important:
  370.   - Problems with attachments from local mail and MHS mail being
  371.     lost when moved between folders have been fixed.
  372.   - Pegasus Mail will no longer report "Invalid message format"
  373.     when mail passes through a PMDF relay and has its headers 
  374.     rearranged.
  375.   - A change to the way Pegasus Mail responds to confirmation of
  376.     reading should reduce problems people have had with reading 
  377.     confirmations going to mailing lists.
  378. The PMAIL User's Group is a mailing list on which discussion
  379. and assistance for Pegasus Mail matters is available. It is
  380. operated by the University of Alabama in Tuscaloosa - my 
  381. sincere thanks to James Ford and the Administration of the
  382. University for making the service available.
  383. You can subscribe to this mailing list by sending a message to
  384. listserv@ua1vm.ua.edu
  385.  (note: from CompuServe, use the address
  386. >internet:listserv@ua1vm.ua.edu
  387. ) with the message body set to:
  388.      SUBSCRIBE PMAIL firstname lastname
  389. Example: your name is Jose Bloggs - you would send:
  390.      SUBSCRIBE PMAIL Jose Bloggs
  391. Send discussion to pmail@ua1vm.ua.edu. Please note that the
  392. discussion address and the subscription addresses are not the
  393. same.
  394. The PM-NEWS announcement list is a mailing list operated by
  395. the University of Alabama in Tuscaloosa, providing low-volume
  396. notification of new releases and important notices. The list
  397. is moderated, which means that only the list owner can send
  398. messages to the list, but anyone can subscribe to it.
  399. If all you want is to be told about new releases of Pegasus 
  400. Mail and related products, this list is the one for you.
  401. You can subscribe to this mailing list by sending a message to
  402. listserv@ua1vm.ua.edu
  403.  (note: from CompuServe, use the address
  404. >internet:listserv@ua1vm.ua.edu
  405. ) with the message body set to:
  406.      SUBSCRIBE PM-NEWS firstname lastname
  407. Example: your name is Jose Bloggs - you would send:
  408.      SUBSCRIBE PM-NEWS Jose Bloggs
  409. If you have information you want posted to the PM-NEWS list,
  410. send it to PM-NEWS@ua1vm.ua.edu: your message will be referred
  411. to the list moderator, who will decided whether or not it
  412. should be distributed to the wider list membership.
  413. WinPMail version 1.2 supports user-defined gateways, but
  414. with some limitations compared with Pegasus Mail/DOS.
  415.  Validation routines defined for gateways will not work.
  416.  Gateways which require a program to be run will work,
  417.   but you may have to fiddle with the Windows icon unless
  418.   you can run the program from a PIF file.
  419.  There is no equivalent of PM-MENU.RSC in WinPMail 1.2
  420.   to allow you to add items to the menus at this stage.
  421. WinPMail 1.2 is the the latest release of Pegasus Mail for
  422. Windows, the most recent member of the Pegasus Mail family.
  423. It is functionally equivalent to or more advanced than the
  424. 3.20 release of the DOS version of Pegasus Mail. Any problems
  425. with this version are noted in the next section.
  426. If you encounter problems in this version, please report them
  427. by electronic mail as follows:
  428. Internet:    david@pmail.gen.nz
  429. CompuServe:  >internet:david@pmail.gen.nz
  430. WinPMail v1.2 has the following problems or restrictions:
  431.   While noticeboards are implemented in WinPMail now,
  432.    no management facilities exist within the program;
  433.    noticeboard management must be done using a DOS
  434.    version of Pegasus Mail v3.1 or later.
  435.   Bitmaps may be slightly misaligned on some Super VGA
  436.    video systems running at 1024x768; this typically happens
  437.    if you use a "large font" driver - one which changes the
  438.    size of the System font.
  439.   WinPMail no longer has direct support for Windows 3.0;
  440.    you may be able to get it to run in this environment but
  441.    no technical support is offered.
  442. The <Tab> key has caused me considerable trouble in WinPMail;
  443. the Windows standard defines <Tab> as meaning "Advance to the
  444. next control on the screen", but most users seem to prefer to
  445. use <Tab> to enter tabs into their messages.
  446. In WinPMail, I have provided the facility to use the Tab
  447. key to Tab in the message editor, but it is turned off by
  448. default. This is necessary to preserve compatibility for the
  449. few users who use Windows without a Mouse, and to remain at
  450. least nominally compliant with CUA.
  451. If you prefer to use the <Tab> key to tab in your message,
  452. follow these steps:
  453.  Start a new message
  454.  Click the "Special options" button at the left.
  455.  Set a tab width (4 is good). Note that this value is
  456.      only approximate if you are using a proportionally-spaced
  457.      font in the message editor.
  458.  Click the "Use as default" checkbox next to the Tab value
  459.      then click on OK to close the dialog. 
  460.  Cancel the message.
  461. All future messages will allow Tabs in the message editor. A
  462. side-effect of this fix is that Ctrl-Enter will send the message
  463. (just like the DOS version of Pegasus Mail) if you have this
  464. turned on.
  465. To configure WinPMail to work with the Mercury SMTP gateway,
  466. follow the steps in this guide covering installation for the
  467. Charon SMTP gateway: from Pegasus Mail's perspective, both
  468. transports have an identical interface.
  469. WinPMail v1.0 has support for all NetWare MHS features,
  470. and is fully SMF-71 compliant, which means that it takes
  471. advantage of the special features offered by the new
  472. generation of MHS mail systems such as NetWare Global MHS.
  473. If you have previously used any version of Pegasus Mail, it
  474. is as well to run PCONFIG and check the way your copy of
  475. Pegasus Mail is configured for MHS: if you are using NetWare
  476. MHS 1.5, make sure that the "SMF-71 available?" field is set
  477. to 'N'. Also make sure that all the other values are sensible.
  478. WinPMail has not been thoroughly tested under NetWare 4.0
  479. but appears to work if you have Bindery Emulation loaded on
  480. the server.
  481. Native NDS support for Pegasus Mail will be available for
  482. the next release of NetWare 4.x sometime this year.
  483. Pegasus Mail for Windows is a substantial rework of the entire
  484. program and contains improvements and additions too numerous to
  485. mention. Having said this, the look and feel of the program should
  486. not be in any way uncomfortable for anyone used to version 1.02.
  487. Here are the major changes in v1.1 of WinPMail:
  488. *  Built-in SMTP and POP3 support using any WINSOCK-compliant
  489.    protocol stack.
  490. *  Support for standalone operation. WinPMail now no longer requires a 
  491.    connection to a NetWare server in order to operate. In fact, using 
  492.    its built-in TCP/IP mail capabilities, it is now a quite competetive 
  493.    mailer in the non-NetWare environment.
  494. *  Hierarchical foldering, compatible with Pegasus Mail/DOS v3.x
  495. *  Spelling checker (finally!)
  496. *  Toolbar support (although you can still have the traditional
  497.    WinPMail button panel if you wish). The toolbar is enabled or
  498.    disabled using a new preferences menu submenu item. First-time
  499.    users will automatically get a toolbar.
  500. *  MIME support to the same general level as the DOS version,
  501.    although MIME digests are currently not supported.
  502. *  Vastly enhanced message editor, with support for indenting,
  503.    paragraph reformat, search and replace and more. The problems
  504.    many people had with replies getting grossly misformatted under
  505.    WinPMail 1.02 are now a thing of the past.
  506. *  Support for the addressbook quick-lookup feature found in the
  507.    DOS version, using the same key (Shift+F3).
  508. *  Quick address entry buttons in the message editor for the last
  509.    50 addresses you have used.
  510. *  Save desktop state between sessions: WinPMail can now remember
  511.    the folders, addressbooks and whatever else were open the last
  512.    time you quit the program and restore them to the same state and
  513.    position when it restarts.
  514. *  Ability to mark messages as unread in folders
  515. *  The infamous "resource leak" has been fixed.
  516. *  Powerful message extraction option allows you to save messages to
  517.    single or multiple files easily with a single command.
  518. *  Word wrap now available in the message reader
  519. *  The options on the folder window's "Special" submenu (such as
  520.    uudecode, unbinhex and so forth) are now also available in the
  521.    message reader.
  522. *  Vastly improved detection and handling of attachments generated
  523.    by other Internet mailers. It's still not perfect, because a
  524.    number of other mailers insist on the objectionable practice of
  525.    enclosing attachments at the end of the message, but WinPMail
  526.    will now detect most instances of this kind of behaviour and deal
  527.    with them correctly.
  528. *  Ability to view attachments: if an attachment to a message has
  529.    an extension WinPMail can match to any of the extensions
  530.    supported by applications on your system (via the[Extensions]
  531.    section of WIN.INI), then it can start the application
  532.    automatically with the attachment to display it.
  533. *  Ability to suppress "Are you sure you want to delete this
  534.    message" prompts.
  535. *  Many user-interface improvements - for example, in the local
  536.    users list screen (F2) there is now a drop-down list of all the
  537.    available servers on the network from which the user can choose.
  538. *  Ability to select a different file server from within WinPMail,
  539.    and problems to do with losing the server connection which many
  540.    people experienced under WinPMail 1.02 have been fixed
  541.    completely.
  542. *  Many more accelerator keys, and better support in general for
  543.    keyboard use of the program.
  544. *  Ability to specify whether copies-to-self of encrypted messages
  545.    should be stored encrypted or as plain text. 
  546. *  More logical window staggering - WinPMail now tries to make sure
  547.    that windows are entirely visible within the main frame when it
  548.    opens them.
  549. *  List controls now behave in a more "Standard" way - Shift+Click
  550.    does a range fill selection, and Ctrl+Click does a disjoint
  551.    selection.
  552. The following features do not appear in this version, but are
  553. planned for future releases:
  554.   DDE (Dynamic Data Exchange) support
  555.   OLE-2 support
  556.   MAPI support
  557.                  
  558.                  
  559.     Welcome to WinPMail v1.2     
  560.                  
  561.    Pegasus Mail is an electronic mail system for use with Novell 
  562. NetWare (versions 2.15A and later), and on standalone systems using
  563. the WINSOCK TCP/IP interface. It is a fully-fledged mailer, one of
  564. its more unusual characteristics being that it is free - not
  565. shareware, but free. You can use it without charge, restriction or
  566. obligation on as many servers and machines as you wish.
  567.    I do sell manuals for the program, in order to support development 
  568. costs, but manual purchases are strictly optional. An order form for
  569. manuals is provided in this guide - please print it out and attach it
  570. to your order form or cheque if you place an order.
  571.    WinPMail requires DOS 3.0 or later and Windows v3.1 or later to
  572. run. WinPMail will only run in Standard or Enhanced modes.
  573.    Pegasus Mail has been tested under NetWare 2.12, NetWare 2.15A-C,
  574. all versions of 3.x, and on 4.0x in Bindery Emulation mode only.
  575. It will run on any station equipped with any version of IPX and NETx,
  576. on any network topology.
  577. I give Pegasus Mail away for a number of reasons, very few of them
  578. logical. One of the main reasons, however, is the intense satisfaction
  579. I get from knowing that people like using it. I am very receptive to
  580. comments and criticisms about Pegasus Mail, and intend to support it
  581. for as long as people want to use it.
  582. The best way to reach me is by e-mail: if you have access to the 
  583. Internet, then you can mail me at the following Internet address:
  584.         
  585. david@pmail.gen.nz
  586. From CompuServe, you can mail to me at this addresses by prefixing
  587. it with 
  588. >internet:
  589.  - e.g. 
  590. >internet:david@pmail.gen.nz
  591. . I'm not
  592. currently addressable via MHS, but hope to be in the future. 
  593. If you wish, you can fax me at 
  594. (+64) 3 453 6612
  595. I can be phoned at 
  596. (+64) 3 453 6880
  597. , but 
  598. LPLEASE
  599. @ remember that New
  600. Zealand is 
  601. LGMT+1200
  602. @... I am generally pretty grumpy about being woken
  603. at 4am by ANYONE! Because of the volume of information I have to deal
  604. with, faxing me, or sending me paper mail will generally not elicit a
  605. fast response - I apologise in advance for this, but there's only so
  606. much one person can do. My postal address is:
  607.         Pegasus Mail, c/- David Harris,
  608.         P.O. Box 5451,
  609.         Dunedin, New Zealand.
  610. Pegasus Mail can talk to UNIX and other TCP/IP based hosts via the
  611. Charon SMTP gateway from Clarkson University, or using my own Mercury
  612. Message Transport System. WinPMail does not distinguish between the
  613. two systems - configure WinPMail to work with Mercury as you would
  614. for Charon.
  615. The Mercury Mail Transport System, by the author of Pegasus Mail, is
  616. a comprehensive Internet mail solution implemented as a set of NLMs
  617. for NetWare 3.11 and later. It is fast, small, efficient and has a
  618. considerable range of features, including a fully-fledged list and
  619. mail server, aliasing, autoreply and more. It is available from the
  620. same sites as Pegasus Mail - risc.ua.edu in /pub/network/pegasus is a
  621. good place to start looking.  At the time of writing the current
  622. Mercury version is 1.13.
  623. Charon: Developed by 
  624. Brad Clements
  625. , and a product of Clarkson
  626. University, Charon is a dedicated server which can service mail on up
  627. to 8 NetWare servers simultaneously. Pegasus Mail and Charon were
  628. written with each other in mind, and work very well together. They
  629. interact via NetWare Print Queues, which makes for easy management
  630. (using the NetWare PCONSOLE utility).
  631. Charon uses Packet Drivers to talk both TCP/IP and IPX at the same
  632. time, and requires the use of MX entries on a BIND/DNS system to
  633. operate to best effect. It supports aliasing, has a Finger server,
  634. and supports remote management via Telnet. Charon is free software.
  635. Charon is available via anonymous FTP from risc.ua.edu (130.160.4.7)
  636. in /pub/network/pegasus/charon.zip.
  637. Pegasus Mail has been in widespread use since June 1990. Since that
  638. time, various people have had a significant influence on its growth
  639. and acceptance in the e-mail community. The following list is by no
  640. means complete, and I apologise to anyone whose name I have missed -
  641. it is not for lack of appreciation, believe me!
  642. Brad Clements
  643. , formerly of Clarkson University and now the
  644.      CEO of MurkWorks, Inc (a specialist software development
  645.      company in New York State), for working hard and without much
  646.      thanks on the excellent Charon SMTP gateway which Pegasus Mail
  647.      knows how to use. Brad's ongoing influence on Pegasus Mail is
  648.      beyond estimation.
  649. James Ford
  650.  for maintaining the PMAIL users group, and for
  651.      making risc.ua.edu, my principal distribution point, available.
  652. Industrial Research Limited, New Zealand
  653. , whose support of the
  654.      costs of my Internet link make it possible for me to continue
  655.      supporting Pegasus Mail aggressively.
  656. Janet Perry, Manoj Goel
  657.  and 
  658. Kirk Johnson
  659.  from Novell Inc, who
  660.      have helped in many, many ways.
  661. Steve Dart, Ton Roovers, Douwe Fokkinga, Andrew Morrow, Hans
  662.      
  663. van Oostrom, Brendan Boerner, John Baird, David Kocmoud
  664.  and the
  665.      other people who helped test the system (and put up with all the
  666.      headaches!).
  667.   And to all the sites who have purchased manuals: this financial
  668.      support has been critical in allowing me to continue supporting
  669.      and enhancing Pegasus Mail.
  670. This user guide was created entirely using another of my programs,
  671. called 
  672. David's Readme Compiler
  673.  (DRC). DRC allows you to take
  674. a simple text file and "compile" it into a single .EXE file which
  675. you can include with your program. This reduces the number of files
  676. you need to supply. DRC allows you to create hierarchical sub-topics
  677. nested arbitrarily deeply and to control text attributes and colour.
  678. It also has a mode which leaves the screen undisturbed, so you can
  679. run it as a help system from inside other programs.
  680. DRC is 
  681. totally free
  682. , no catches, gotchas or gimmes. You can get it
  683. via anonymous FTP from 
  684. risc.ua.edu
  685.  in /pub/network/pegasus/drc21.zip.
  686. Drc21.zip can also be found at splicer2.cba.hawaii.edu in the directory
  687. /files/pegasus. I hope to make it available on CompuServe when I get
  688. the time.
  689. To install WinPMail, copy the files WINPMAIL.EXE, WINPMAIL.HLP and
  690. WINPMAIL.DAT to a public directory on your file server: note that
  691. all three must be in the same location. If you want to use the
  692. Spelling checker option in WinPMail, then you must also place the
  693. file PMDICT3.PMD in the same directory as WINPMAIL.EXE, or somewhere
  694. on the DOS path. The files BWCC.DLL and NWCALLS.DLL (and SHELL.DLL
  695. if you don't already have it) should be placed in one of the
  696. following locations:
  697.  Anywhere on the DOS path
  698.  In \WINDOWS\SYSTEM
  699.  In the same directory as WINPMAIL.EXE
  700. If you install WinPMail on the 
  701. file server
  702. , make sure that
  703. WINPMAIL.EXE, WINPMAIL.HLP and WINPMAIL.DAT are all flagged
  704. SHAREABLE
  705.  - this is very important. WinPMail.exe cannot be flagged
  706. Execute-only (nor can any Windows application, in fact).
  707. WinPMail currently does not have a fancy installer to create a
  708. Program Manager group for it - you have to do this yourself. I
  709. hope to produce a fancy installer for a future version.
  710. Existing users can use the program immediately. There are no extra
  711. steps required when creating users to allow them to use the system -
  712. WinPMail learns all it needs about the user from the NetWare Bindery.
  713. You should modify NET$LOG.DAT, the NetWare system login script, on
  714. the host server to contain commands similar to the following:
  715.      #newmail
  716.      if "%ERROR_LEVEL" > "0" then begin
  717.         write ""
  718.         pause
  719.      end
  720. This invokes the Pegasus Mail newmail utility, which reports the
  721. number of unread messages the user has when he logs in. The write
  722. statement prints a blank line, while the pause statement gives the
  723. user a chance to see the message printed by newmail.
  724. Newmail will check for new mail on all servers to which you are
  725. attached and logged in. SUPERVISOR-equivalent users can check for
  726. mail for other users on the default server by entering "newmail
  727. USERNAME".
  728. If you are connected to more than one NetWare file server
  729. when WinPMail runs, it will use whatever is your current
  730. Default server.
  731. You can tell WinPMail to use a particular server using a
  732. -P command-line option in the group entry you create in
  733. the program manager. To do this, edit the properties of
  734. the WinPMail Program Manager Icon so that the run command
  735. looks like this:
  736.     d:\path\WINPMAIL.EXE -P <SERVER>
  737. Replacing <SERVER> with the name of the server you want
  738. WinPMail to use. You must already be logged into the 
  739. server before running WinPMail - it will not connect you.
  740. You can also change the file server you are using from
  741. within the program, using the "File Servers" option on the
  742. "File" menu.
  743. Some features in Pegasus Mail are only available if the
  744. user has been authorised to use them. These are:
  745.    Autoforwarding, mail disable, notification disable,
  746.    and denial of receipt confirmation.
  747. Because granting these rights requires the creation of a
  748. property in the NetWare bindery, they must be explicitly
  749. granted by a SUPERVISOR-equivalent user. You can control
  750. whether or not a user can modify these settings as well.
  751. To grant extended options to a user, either use PCONFIG,
  752. selecting "Grant extended feature rights", or else use
  753. PMGRANT.EXE, which allows you to use wildcard characters.
  754. Pegasus Mail can deliver mail to users on other file servers if
  755. access codes are provided. When a user attempts to send mail to a
  756. user on a remote server, Pegasus Mail searches a Supervisor-defined
  757. internal table for a usercode and password on the remote server. If
  758. one is found, the system uses it to log into the remote server and
  759. deliver the message. If none is found, the system attempts to log
  760. into the remote server as the NetWare GUEST user. If all attempts
  761. fail, an error is reported to the user.
  762. To define the access information Pegasus Mail needs for remote
  763. servers, the Supervisor or a Supervisor-equivalent user should run
  764. the pconfig.exe program on the distribution disk. Pconfig presents a
  765. menu offering `Interface definition' (this option is covered later)
  766. and `Server Access definition'. Select the latter, and a window will
  767. open. If you press <Enter> while the `Add a server' entry is high-
  768. lighted, another window will open prompting you for information about
  769. the remote host. 
  770. You should enter the file server's name, and a usercode and password
  771. Pegasus Mail can use on that server. The data is stored in a heavily-
  772. encrypted format which should be secure from even an ardent hacker.
  773. You can create any number of entries for remote server access the
  774. list will scroll when you have filled the window. When you have
  775. finished defining servers, press <Ctrl-Enter> to accept the
  776. definitions and return to the main menu. Choose `Save and Exit' to
  777. store the definitions.
  778. The usercode you create for mail access should be extremely limited.
  779. I recommend that it NOT be a member of group EVERYONE, and that it
  780. should have only one explicit trustee right granted to it [C] (or
  781. [CW] under NetWare 286) rights in SYS:MAIL. Pegasus Mail does not
  782. need access to any other directory on the host server, nor does it
  783. need access to any NetWare utilities.
  784. Pegasus Mail logs into the remote server for the shortest possible
  785. time to deliver mail or examine usernames, and guarantees that the
  786. user will never be left logged-in to the remote host under the mail
  787. usercode.
  788. Note:  if a mail usercode on a remote server has an expired password,
  789. Pegasus Mail will fail when delivering the message, even if grace
  790. logins are enabled and plentifully available.
  791. WinPMail supports the Charon v3 SMTP gateway by Brad Clements of
  792. Clarkson University and the Mercury Mail Transport System using
  793. the same configuration information.
  794. To install WinPMail to use these gateways, run the Pconfig program 
  795. supplied and choose `define Clarkson interface': a dialog window will
  796. appear. You must provide the following information:
  797. Spool interface?
  798.   If you are using Mercury 1.11 or later as your
  799.    SMTP transport agent, you can select either a queue or a directory
  800.    interface to Mercury. The directory interface has some advantages
  801.    over the queue interface and is the only way of running Mercury
  802.    under NetWare 4.0 at this time. For more information on using the
  803.    spool directory interface to Mercury, see the Mercury 1.11 guide.
  804. Queue name
  805. :  this is the name of the print queue you have created
  806.    (using the NetWare PConsole utility) from which Charon or Mercury
  807.    expects to retrieve messages. The queue need not exist at the time
  808.    you define the interface. If you have installed Mercury 1.11 using
  809.    the spool directory interface, you should enter the path to the
  810.    Mercury spool directory in this field, preferably in the MS-Net UNC
  811.    format of 
  812. \\SERVER\VOLUME\PATH
  813. Use always
  814. :  enter `Y' if you want WinPMail to use the gateway 
  815.    for all messages, including mail to other servers. If you select 
  816.    `N', Pegasus Mail will only pass mail with Internet addresses to 
  817.    the gateway, and will use its own mechanism for all other messages.
  818. Server's internet name
  819. : Enter here the internet identity you have
  820.    defined for this file server. Note that this is NOT the same as the
  821.    name of the gateway itself. This address is used to form the sender's
  822.    address for replies. For more information on naming, see the Charon 
  823.    manual. The name you enter in this field should be fully domain
  824.    extended - that is, you should include the domain as well as the
  825.    host name.
  826. Our time zone
  827. :  Type here the UNIX-format abbreviation for your time
  828.    zone:  this is required by the RFC822 standard for message format.
  829.    Examples of time zones are:  EDT, PST, GMT, GMT+1200.
  830. When you have filled in all the blanks, accept the data. That's all
  831. there is to it!
  832. Because Internet mail is a 7-bit format, you cannot send 8-bit
  833. data across it. Accented characters in the IBM character set
  834. are 8-bit data and must be converted to an alternate format
  835. (usually simple ASCII) for transmission.
  836. WinPMail has a default translation table for 8-bit data which
  837. it applies to messages sent via an Internet transport (such as
  838. Charon or Mercury). The default table is intended to work with
  839. code page 437 and may be unsatisfactory in other environments.
  840. You can override the default table by creating a resource file
  841. called WPM-CHAR.RSC in the same directory as WINPMAIL.EXE or
  842. in your home mailbox.
  843. A sample WPM-CHAR translation table is provided with WinPMail as
  844. WPM-CHAR.R. Examine this file for details on how to customise the
  845. SMTP tables at your site.
  846. WinPMail v1.2 supports noticeboards - discussion areas available
  847. to designated users. Noticeboards are accessed by clicking the
  848. pinboard icon on the toolbar, or by selecting "noticeboards" from
  849. the file menu.
  850. Setting up noticeboards
  851. To initialize noticeboards, follow these steps:
  852.    *  Create a root noticeboard directory somewhere on your file
  853.       server. I recommend SYS:PUBLIC/NB, but it can be anywhere.
  854.    *  In this directory, create a file called NB.ID. The file can
  855.       be empty, although in standalone and non-NetWare setups it
  856.       should contain this line:
  857.            Administrator: <username>
  858.       - where <username> is the name of the noticeboard manager.
  859.    *  Set an environment variable called NB which points to the
  860.       directory you have set up. The best way to do this is to use
  861.       UNC path notation - for example, \\SERVER\SYS\PUBLIC\NB. You
  862.       will probably want to create this variable in your system
  863.       login script.
  864. That's about all it takes. Simple noticeboard administration can
  865. be done by administrator users within Pegasus Mail for DOS - the
  866. Windows version of Pegasus Mail will have similar management
  867. facilities in due course.
  868. You can control access to noticeboards by altering the rights
  869. masks on the directories created under the NB location on your
  870. server. Manual maintenance of noticeboards can be done by editing
  871. the file NB.ID in each noticeboard directory. NB.ID is a simple,
  872. fairly self-explanatory text file which can be edited using any
  873. text editor, even (shudder) the DOS EDIT command.
  874. Expiration NLM
  875. A NetWare NLM is available which can handle automatic expiration
  876. of messages on noticeboards. Get NBEXPIRE.ZIP from the site where
  877. you found Pegasus Mail.
  878. Advanced management tool
  879. An advanced management tool is also planned for Pegasus Mail's
  880. noticeboard system: it should make it easy to maintain access and
  881. posting rights within the system and should also be out within
  882. a couple of months of the release of Pegasus Mail v1.2.
  883. Many aspects of Pegasus Mail's operation can be controlled using
  884. NetWare User Groups (created using the NetWare SYSCON utility).
  885. Pegasus Mail currently recognizes the following NetWare groups:
  886.      GROUPMAIL   Those who MAY send to NetWare groups
  887.    NOGROUPMAIL   Those who may NOT send to NetWare groups
  888.        MAILBOX   Those who MAY have a home mailbox on the server
  889.      NOMAILBOX   Those who may NOT have a home mailbox on the server
  890.      MAILUSERS   Those who MAY use Pegasus Mail to send mail
  891.         NOMAIL   Those who may NOT use Pegasus Mail
  892.         PMSEND   Those who MAY send one-line messages from <F4>
  893.       NOPMSEND   Those who may NOT send one-line messages from <F4>
  894.         BECOME   Those users who may access another users mailbox
  895. In the absence of both allowing and disallowing groups, the default is
  896. that all users have access; so, if there is no MAILUSERS and no NOMAIL
  897. group, then all users may use mail. The exception to this is the
  898. BECOME group, which MUST exist before any user can access another
  899. user's mailbox.
  900. Instructions for creating system-wide entries:
  901. Creating system-wide distribution lists:
  902.    Distribution lists are text files with the extension 
  903.    make a distribution list system-wide, copy it into the same
  904.    directory as PMAIL.EXE, or else put it in a publicly-accessible
  905.    location on the server and set a PML DOS environment variable to
  906.    point to that location.
  907. Creating system-wide address books:
  908.    Address books consist of two files - name
  909.  and name
  910.    create a system-wide address book, copy both files for the book
  911.    into the same directory on the server as PMAIL.EXE. Alternatively,
  912.    copy the files into a public directory then set a DOS environment
  913.    variable called PMR which points to that directory. If the address
  914.    book is large and changes little, consider creating a secondary
  915.    index for it using PMSORT.EXE - this will markedly speed up the
  916.    process of opening the book.
  917. Creating system-wide mail folders:
  918.    In the same directory on the server as PMAIL.EXE, create a sub-
  919.    directory with the extension 
  920.  - the name is unimportant. In
  921.    this directory, create a file called 
  922. PMFOLDER.ID
  923. , which contains
  924.    the long name of the folder. On some systems, you may have to
  925.    edit the file using a binary editor (such as Norton's DE) so that
  926.    the last character in the file is an ASCII 0.
  927.    Once you have created the folder and the name file, grant rights
  928.    to the directory as required: in order to read messages, users will
  929.    need [RF] rights; in order to move messages into the folder, they
  930.    will need at least [RWCF] rights.
  931. WinPMail has native support for Novell MHS version 1.5 and later.
  932. To enable MHS support, run PCONFIG (you must be a SUPERVISOR-
  933. equivalent user to do this), and choose "Define Novell MHS interface"
  934. from the main menu. A window will open, presenting the following
  935. editable fields:
  936. Enabled: 
  937.     If 'Y', this field indicates that MHS mail capability is available
  938.     on this server. If 'N', WinPMail will generate an error message if
  939.     a user attempts to enter an MHS address.
  940. Preferred:
  941.     This flag only has meaning if the Charon SMTP gateway is also
  942.     installed on the current system. Some MHS and SMTP addresses are
  943.     indistinguishable from each other (canonical MHS addresses are
  944.     ALWAYS correctly sensed): if such an address is detected by
  945.     Pegasus Mail, it will be routed to whichever transport has its
  946.     "preferred" flag set. If NEITHER transport has its preferred flag
  947.     set, then the user will be asked to use an explicit override
  948.     (either MHS: for MHS addresses, or IN: for SMTP addresses).
  949. Use always?
  950.     If set to 'Y', then all messages will be routed to MHS
  951.     irrespective of apparent address format. WinPMail will rewrite
  952.     addresses without workgroup parts, using the name defined for
  953.     this host (so, a message addressed to "david" will be rewritten
  954.     as "david @ hostname"). WinPMail won't use its own local delivery
  955.     agent, and messages to the Charon SMTP gateway (if present) will
  956.     have to be overridden always (using the IN: prefix).
  957.     NOTE: Hardened MHS users may instinctively wish to set this field
  958.     to 'Y', but in general, Pegasus Mail will perform better if it is
  959.     set to 'N', since its own delivery agent is extremely efficient.
  960.     We recommend that this field be set to 'Y' only in an extremely
  961.     heavy MHS environment - ie, one where a number of MHS mailers
  962.     are used, to the exclusion of all other protocols.
  963. Default workgroup:
  964.     This is the name of the local host/workgroup as defined in the
  965.     installation of MHS on the current server. Pegasus Mail uses this
  966.     name to construct the "From:" field of messages, and when writing
  967.     addresses to MHS format.
  968. Local delivery:
  969.     This option only has meaning at sites where both MHS and the
  970.     Charon Internet gateway are used simultaneously. If this flag
  971.     is set to 'Y', then MHS will be used for any local mail - that
  972.     is, Pegasus Mail's own delivery agent will be disabled. So,
  973.     where an address such as "DAVID" would usually be taken as a
  974.     local Pegasus Mail address, if this flag is set, then Pegasus
  975.     Mail will treat it as an MHS address instead.
  976.     This option does NOT cause Pegasus Mail to attempt local MHS
  977.     delivery without MHS - Pegasus Mail will never do this: MHS
  978.     MUST be running on your system for any MHS delivery to occur.
  979. SMF-71 available?
  980.     Set this flag to 'Y' if you are using an SMF-71 transport such
  981.     as NetWare Global Messaging, or MHS v2.0. For MHS 1.5, set it
  982.     to N.
  983. UTC Time value
  984.     Enter here the time offset of your area from GMT, expressed as
  985.     a positive or negative 4-digit value; New Zealand, for instance
  986.     is 12 hours ahead of GMT, so you would enter +1200 here. MHS 1.5
  987.     does not require this field to be completed.
  988. Use SMFSEND
  989.     If set to 'Y', then Pegasus Mail will attempt to use the MHS
  990.     SMFSEND utility to deliver mail. On some systems this will permit
  991.     mail to be delivered locally without having MHS running, but
  992.     SMFSEND is not the most reliable utility in the world, and
  993.     performance using this feature may be erratic.
  994.   * Note: WinPMail cannot use SMFSEND to deliver mail in any event
  995. DOS MV path
  996.     Enter here the path to the MHS tree - exactly the same as the
  997.     MV environment value set at the DOS level. While Pegasus Mail
  998.     will function correctly if this value is not set, you will not
  999.     be able to change file servers reliably from the Pegasus Mail
  1000.     main menu if it is not.
  1001. WinPMail includes a number of user configuration options in its
  1002. preferences menu:
  1003. SMF/MHS user name
  1004. : if a user has an MHS mail identity which is
  1005.    different from his/her NetWare usercode, then he/she will have to
  1006.    enter that identity in this field. The default is the first eight
  1007.    characters of the user's NetWare userid. If you are using an SMF-
  1008.    71 transport, such as NetWare Global Messaging, then this field
  1009.    can contain a full address, such as "David Harris@Pmail.gen.nz".
  1010.    Pegasus Mail uses this value to create the "From" field of
  1011.    outgoing messages.
  1012. MHS/SMF mailbox name
  1013. : each user has a directory in the MHS
  1014.    directory tree where new mail is stored. In almost all cases
  1015.    this will have the same name as the first eight characters of
  1016.    the user's NetWare username, but very occasionally it might
  1017.    be different. If it IS different, then Pegasus Mail will not be
  1018.    able to find new mail for the user until the correct name is
  1019.    entered here.
  1020. MHS App name
  1021. : if a preferred mailer has not been specified for a
  1022.    user when he/she was added to the MHS system, then mail will be
  1023.    delivered by default to an MHS application directory called MHS.
  1024.    Normally, Pegasus Mail should be installed in your MHS system
  1025.    using the application name PMAIL, which has been reserved with
  1026.    Novell: if, however, you are installing Pegasus Mail over the top
  1027.    of an existing MHS mailer, you may not wish to alter all the users.
  1028.    In either of the cases described here, you can change the name of
  1029.    the application directory Pegasus Mail will scan for new mail by
  1030.    entering its name in this field.
  1031. Scan MHS dir for new mail?
  1032.  If set to Y, then Pegasus Mail will
  1033.    scan the user's default 'MHS' mailer directory for new mail, as
  1034.    well as scanning whatever directory is defined in "MHS App name".
  1035. Pegasus Mail understands and uses MHS extended addressing, and will
  1036. add any personal name the user has defined (under General Settings in
  1037. the Preferences menu) to his address in outgoing messages: this will
  1038. result in addresses of the form:
  1039.              joeblogg @ thalia (Joseph Bloggs)
  1040. In outgoing messages. This syntax is legal, but might possible
  1041. confuse older mailers which do not understand MHS extended address
  1042. forms. The advantage of adding the comment field is that Pegasus Mail
  1043. can pick it out of the address and display it in the message browse
  1044. list; the personal name is 'friendlier' than a raw address.
  1045. The following guidelines can be used as a guide when trying to decide
  1046. the best way of configuring Pegasus Mail to operate with MHS at your site.
  1047. 1: Sites using Pegasus Mail only, No SMTP, and MHS to deliver between
  1048.    servers: Set "Preferred" to 'N'; "Use always" to 'N'; "Enabled" to
  1049.    'Y'.
  1050. 2: Sites using MHS and SMTP (Charon) on the same system:
  1051.    Set "Preferred" to 'Y' if most mail traffic is MHS, otherwise set
  1052.    it to 'N'; "Enabled" to 'Y'; "Use always" to 'N'.
  1053. 3: Heavy MHS sites using more than one MHS mailer, and no SMTP.
  1054.    Set "Preferred", "Enabled" and "Use always" to 'Y'.
  1055. WinPMail understands three different message formats: RFC-822, the
  1056. Internet mail format; MHS SMF-70, the format of MHS 1.5, and SMF-71,
  1057. the format of NetWare Global Messaging and MHS v2. It can distinguish
  1058. between the message formats transparently: WinPMail's own mail agent
  1059. uses the RFC-822 format. WinPMail stores all new mail in the user's
  1060. unique mail directory in SYS:MAIL, irrespective of the transport
  1061. used: if new MHS messages are detected in MV/.../USERS/APPNAME, they
  1062. are moved to the user's SYS:MAIL directory before being read, along
  1063. with any associated attachments. After being read, messages may
  1064. migrate to a user-specified home mailbox (perhaps on a local drive)
  1065. or may be left in SYS:MAIL/USERID, depending on user configuration.
  1066. Outgoing mail is ALWAYS placed in MV/MHS/MAIL/SND for routing via
  1067. MHS, as per the recommendation in the "MHS 1.5 Technical Overview".
  1068. WinPMail will NOT attempt local MHS delivery on its own - the MHS 
  1069. Connectivity Manager must be running for mail to be delivered.
  1070. Since the expected main use of Pegasus Mail is in sites where its
  1071. own agent is used for local delivery, and MHS is used for off-site
  1072. transport, this should present no problems.
  1073.  Local delivery: Pegasus Mail will NEVER attempt to perform local
  1074. MHS delivery - the MHS Connectivity Manager must be run. The only
  1075. possible exception to this is to use SMFSEND for local delivery, but
  1076. this option has variable reliability.
  1077.  MHS Macros, as defined in the "Technical Summary of MHS 1.5" are
  1078. not supported, will NOT be copied back into replies if referenced,
  1079. but will not generate errors.
  1080.  Confirmation requests: MHS requests for confirmation of receipt are
  1081. honoured: confirmation is generated at the moment the message is
  1082. opened for reading.
  1083. PMGRANT can be used to examine, grant or revoke extended feature
  1084. rights (the ability to autoforward, disable mail, disable receipt
  1085. confirmation and so forth) from the command line. This may be
  1086. desirable if you have a very large bindery, with which PCONFIG
  1087. may not be able to cope.
  1088.    Usage:  pmgrant [option] <username> [parameter]
  1089.       -v: view user's or users' extended rights
  1090.       -d: delete user's extended rights
  1091.       -l: set user's local forwarding address to [parameter]
  1092.      -l-: clear user's local forwarding address
  1093.       -i: set user's Internet forwarding address to [parameter]
  1094.      -i-: clear user's Internet forwarding address
  1095.       -f: set user's address synonym to [parameter]
  1096.      -f-: clear user's address synonym
  1097.    -w[-]: allow/do not allow user to edit extended rights
  1098.    -a[-]: enable/disable delivery even if autoforwarding
  1099.    -m[-]: enable/disable mail delivery altogether
  1100.    -c[-]: honour/refuse requests for confirmation of reading
  1101.    -n[-]: turn on/turn off message arrival broadcast messages
  1102.    <username> may contain wildcards (* and ?)
  1103.    Only one of -v, -l, -i or -f may be used in one invocation.
  1104.    Address synonyms are only valid when using Charon 3.5 or later.
  1105.    If no option is present, the user is granted extended rights.
  1106. Maildir is a simple program to change to a specified user's
  1107. mailbox in SYS:MAIL. It may be useful if you need to check
  1108. on the files in a user's mailbox.
  1109.    Usage:   
  1110. MAILDIR <username>
  1111.    <username> may not contain wildcards.
  1112. PMSORT creates secondary index files for address books.  It is
  1113. intended to be used with very large system-wide address books which
  1114. are otherwise very slow to sort.  Using PMSORT can increase the speed
  1115. by which Pegasus Mail can resort an address book by key by a factor
  1116. of 10. The downside is that while Pegasus Mail will USE the secondary
  1117. index, it won't MAINTAIN it, so any address book with a secondary
  1118. index becomes read-only by definition.
  1119. Usage:  PMSORT <address_book_file>
  1120. PMSort creates the secondary index file in the same location as the
  1121. address book with the extension .PM1.
  1122. PRebuild rebuilds the index file for a damaged Pegasus Mail folder.
  1123. Prebuild assumes that the .PMM file (which contains the actual text
  1124. of the messages in the folder) is intact, and regenerates the index
  1125. from it.
  1126. Although PRebuild is quite safe to use, some information (flag fields
  1127. recording the Read/Replied/Forwarded status of the message) is lost,
  1128. so it should be used only when necessary, and not routinely.
  1129. UNCONFIG removes the Bindery Property Pegasus Mail creates to store
  1130. its configuration information. Very occasionally you may find that
  1131. this property has somehow become corrupt (a good symptom to look for
  1132. is that a Yes/No value in PCONFIG behaves as if set to 'Y', even when
  1133. you set it to 'N').
  1134. In such cases, run UNCONFIG to remove the old property, then run
  1135. PCONFIG again to reinstall a new, correct property.
  1136. UNCONFIG has no effect on user-defined gateways or on extended
  1137. features granted to users. It only affects the configuration Pegasus
  1138. Mail uses for Charon, MHS, and inter-server delivery.
  1139. WINSOCK, or Windows Sockets, is an open specification allowing
  1140. applications to access TCP/IP networking services from any
  1141. compliant implementation. Most modern TCP/IP suites for Windows
  1142. will include WINSOCK.DLL, the file providing these services.
  1143. Pegasus Mail for Windows can use WINSOCK.DLL to perform direct
  1144. TCP/IP-based electronic mail using the SMTP and POP3 protocols.
  1145. If you have a PC attached to a TCP/IP-based network, WinPMail's
  1146. WINSOCK-based mail services may be of use to you. They can be
  1147. used simultaneously with any connection you might have to a
  1148. NetWare server, but do not require a NetWare connection.
  1149. WINSOCK-based mail support is configured using the 
  1150. Network
  1151. Configuration
  1152.  option on the "File" menu. This menu option will
  1153. only appear if a valid WINSOCK.DLL is available on your system.
  1154. Almost all competent TCP/IP implementations for Windows will
  1155. include WINSOCK.DLL, but the following stacks have been more
  1156. widely-tested with WinPMail than most:
  1157.   * LAN Workplace for DOS v4.1 or later, from Novell, Inc.
  1158.   * The Trumpet Winsock, by Peter Tattam.
  1159. WinPMail should, however, work with any properly-implemented
  1160. WINSOCK implementation.
  1161. WinPMail requires no particular installation to use WINSOCK
  1162. services on your system, except that the WINSOCK.DLL must be
  1163. in one of the following locations:
  1164.    * The same directory as WINPMAIL.EXE
  1165.    * In the \WINDOWS directory
  1166.    * In the \WINDOWS\SYSTEM directory
  1167.    * Anywhere else along the DOS PATH
  1168. WinPMail needs to be able to see the actual WINSOCK.DLL file
  1169. in order to use it - it cannot currently detect a WINSOCK.DLL
  1170. which has already been loaded into memory. WinPMail will use
  1171. the first WINSOCK.DLL it can find by searching the locations
  1172. shown above in the order shown.
  1173. If you do not want WinPMail to load WINSOCK.DLL, you can
  1174. prevent it from doing so using any of the following means:
  1175.    * Set "If WINSOCK.DLL is available, load it" to NEVER
  1176.      in your "Advanced Settings" preferences.
  1177.    * Change the command line you use to run WINPMAIL.EXE
  1178.      so that it reads "WINPMAIL -Z 1"
  1179.    * Before running Windows, set a DOS environment variable
  1180.      like this:  "SET WINPMAIL=1"
  1181.    * Removing WINSOCK.DLL from your path.
  1182. * Mail is queued until sent - an indicator in the WinPMail
  1183.   status line shows the number of queued messages. Send queued
  1184.   mail by choosing "Send queued mail" from the file menu.
  1185. * For security reasons, Pegasus Mail will only send SMTP mail
  1186.   if it can first perform a POP3 login to the account you have
  1187.   specified in your Network Configuration screen. The POP3
  1188.   address is written into the "Sender" field of mail you send
  1189.   as a validation of who you really are.
  1190. * Background checking for new mail is configured in the
  1191.   Network Configuration screen. If using a SLIP line or any
  1192.   other slow line you may want to disable periodic checking
  1193.   by setting the idle check time to 0 and disabling checks
  1194.   while the application is minimized.
  1195. * SLIP lines: if using WinPMail and WINSOCK over SLIP (Serial
  1196.   Line IP), you will almost certainly have to set a longer
  1197.   timeout value in the network configuration screen. 45 seconds
  1198.   should be adequate for almost all scenarios.
  1199. Manuals for WinPMail 1.2 are available immediately (as of the date of
  1200. release, 22nd August 1994).
  1201. Pegasus Mail is free software, and is provided with enough
  1202. documentation and online help to be easily usable: no manual is
  1203. provided though.
  1204. In order to support the costs of hardware and software involved in
  1205. developing Pegasus Mail, I sell printed manuals. There is no
  1206. obligation to purchase manuals - none whatsoever. Purchasing manuals
  1207. does, however, help me in my work and also gives you a tangible asset
  1208. for your money. The manual is provided loose-leaf in a protective
  1209. folder, ready for copying. The quality of the manual is high.
  1210. I sell manuals in three ways:
  1211. 5-user manuals
  1212. : you get one printed manual with a license to 
  1213.     make up to 5 further copies. This costs US$175.
  1214. Site-licensed manuals
  1215. : you get one printed manual with a license
  1216.     to make as many copies as you wish for one site. One site is
  1217.     defined as the extent of any organization in any one city or
  1218.     town, so if you have two branches in the same town, one site
  1219.     license will cover both of them. As well as the manual, site
  1220.     licensees get a diskette with RTF and ASCII versions of the 
  1221.     manual. Site licenses cost US$350.
  1222. Any type of manual can be upgraded to the next level for the current
  1223. difference in cost between the two levels.
  1224. Note: as of the release of WinPMail 1.1 and Pegasus Mail/DOS v3.1,
  1225. the "Annual Update License" option which was previously offered
  1226. ceases to be available, although all existing licensees are covered.
  1227. Ordering: to order Pegasus Mail manuals, please fill out the order form
  1228. shown at the end of this file (also in the file ORDER.FRM supplied with
  1229. the distribution) and return it by mail or fax with your purchase order,
  1230. cheque or credit card details to:
  1231.      Pegasus Mail, c/- David Harris,
  1232.      P.O. Box 5451,
  1233.      Dunedin,
  1234.      New Zealand.
  1235.                         (Fax: +64 3 453 6612).
  1236. We do not use postal codes in New Zealand.
  1237. *** If you fax your order to us, please DO NOT send the original by
  1238. *** mail as confirmation.
  1239. Please be sure that you actually complete and enclose our order form - we
  1240. will use it as the final authority for shipping and billing addresses,
  1241. since many organizational purchase orders have ambiguous addressing
  1242. details.
  1243. We are happy to accept purchase orders provided payment is made on normal
  1244. credit terms (nett 30 days).
  1245. Payment must be made in 
  1246. US dollars, drawn on a US bank
  1247. . There is usually
  1248. a delay of around 2 weeks before a manual can be sent out, and I reserve
  1249. the right to hold your order if a new release is pending (so you can get
  1250. the new release). Manuals are always sent by Express Mail Service courier
  1251. (2-4 day delivery anywhere in the world), the fee for which is included in
  1252. the purchase price.
  1253. All manual orders are shipped with a diskette containing the most recent
  1254. version of the program. The manuals are shrink-wrapped, and you may
  1255. request either A4 or US-Letter size versions.
  1256. PLEASE, PLEASE!
  1257.  Remember to enclose the order form: I'm not psychic,
  1258. and I can't guess at delivery addresses from a cheque alone...
  1259. We can accept payment for Manual orders on any valid VISA or
  1260. Mastercard. If you wish to pay this way, please note your card
  1261. number, expiry date, and the name on the card on the order form,
  1262. then sign the order form (signing the form is VERY IMPORTANT - I
  1263. cannot process your order if you do not sign).
  1264. Special Conditions:
  1265. *  Credit card payments attract a 2.5% surcharge which will
  1266.    be automatically added to the voucher.
  1267. *  The amount you are billed will probably not be exactly
  1268.    the amount on the order, because I have to submit the
  1269.    voucher to the VISA Centre converted to New Zealand
  1270.    dollars. I will use the USD conversion rate which
  1271.    applies on the day your order is processed.
  1272. If you are an existing license holder for any other platform of a
  1273. Pegasus Mail manual (ie, DOS or Mac), you can purchase site licensed
  1274. WinPMail manuals for $75 less than the full price (ie, $275). There
  1275. is no discount provided for the purchase of 5-user manuals because
  1276. the production and shipping costs are so high.
  1277. In the past, we have had serious problems keeping pace with orders
  1278. for manuals, which has resulted in appreciable delays in filling
  1279. orders. Our system has been modified to allow faster turnaround on
  1280. manuals and we now ship everything by courier.
  1281. I will accept payment by telegraphic transfer, but you
  1282. should be aware that there are some very particular
  1283. conditions you MUST meet for me to be able to do so.
  1284. Telegraphic Transfer Checklist:
  1285. ------------------------------
  1286.   Your bank must not deduct any fees from the amount
  1287.    invoiced.
  1288.   Transfer to: The National Bank of New Zealand,
  1289.    Dunedin North Branch, account 060-909-0106632-13.
  1290.    The account name is "David Harris Pegasus Mail".
  1291. Your bank MUST ONLY TRANSFER TO MY BANK!!!
  1292.  If your
  1293.    bank transfers to me via any other bank in New
  1294.    Zealand, it will incur processing fees at this end
  1295.    which I will not accept. 
  1296. If your bank cannot trans-
  1297.    fer directly to the National Bank of New Zealand,
  1298.    please pay by cheque. PLEASE ENSURE THAT YOUR BANK
  1299.    UNDERSTANDS THIS CONDITION!
  1300.  Note in particular that
  1301.    the "Bank of New Zealand" and the "National Bank of
  1302.    New Zealand" are different organizations.
  1303.   Please make sure that your bank states my invoice
  1304.    number in the transfer narration, so I can credit
  1305.    the remittance against your invoice.
  1306. A note to European users:  it appears to be common practice for
  1307. European Banks, particularly in Germany, to deduct fees from the
  1308. cheque they send. In some cases, these fees have been as high as
  1309. US$25.
  1310. Because of the costs of manual production, and the relatively small
  1311. amounts involved in the invoice, 
  1312. DEDUCTIONS OF FEES FROM REMITTANCES
  1313. CANNOT BE ACCEPTED!!
  1314.   If your bank deducts fees from the remittance
  1315. you make, I will return the cheque unpresented for repayment. If
  1316. you prefer to make payments via direct credit to a bank account,
  1317. please contact me for details.
  1318. The following terms and conditions apply to all orders for Pegasus
  1319. Mail manual sets. Submitting an order indicates acceptance of these
  1320. terms and conditions in their entirety, over and above any waivers,
  1321. disclaimers or conditions stated on the order itself.
  1322. -------------------- Terms and Conditions ------------------------
  1323. : For licensing purposes, a "site" is the extent of a single
  1324. organization in a single Metropolitan area; so, a University with three
  1325. campuses in the same town would be covered by a single site license,
  1326. but a government department with offices in four separate cities would
  1327. require four licenses. For the purposes of this definition, State,
  1328. National and Municipal Governments do not qualify as "organizations",
  1329. nor do "umbrella" institutions, such as a Board of Education covering
  1330. all high schools in a city.
  1331. Special licensing arrangements
  1332. : We are quite flexible about manual 
  1333. licensing and will gladly consider proposals for special-case
  1334. scenarios.  We also try to help charitable and environmental
  1335. organizations where we can. If you would like to discuss special-case
  1336. licensing, please send Internet e-mail to D.Harris@pmail.gen.nz.
  1337. Purchase orders and payment
  1338. : we are happy to accept purchase orders
  1339. provided that our invoice is paid under normal credit terms (nett 30
  1340. days). We can also accept payment by VISA or Mastercard - in order to
  1341. do so, we need the card number, expiry date, the name exactly as shown
  1342. on the card, and a clear signature on our order form. Credit card pay-
  1343. ments attract a 2.5% surcharge (the fee charged to us by the bank) and
  1344. may not appear as an exact amount on your statement because we have to
  1345. submit our vouchers converted to NZ dollars - we use the exchange rate
  1346. prevailing on the date of processing. If paying by credit card, please
  1347. ensure that the details on your order form are typed, not written.
  1348. Currency
  1349. : all prices are shown in US dollars; we require payment in US 
  1350. DOLLARS DRAWN ON A US BANK. The exception to this is for clients in New
  1351. Zealand, who are welcome to contact us for a New Zealand Dollar rate. 
  1352. Please note the "US Bank" requirement carefully - payments in US Dollars
  1353. drawn on non-US banks attract considerable fees at this end and will be
  1354. returned unpresented.
  1355. Invoices
  1356. : all manual purchases are properly invoiced. New Zealand
  1357. clients will receive a valid Tax Invoice (prices are inclusive of GST
  1358. in NZ).
  1359. Payment by IMT (International Money Transfer)
  1360. : we are willing to accept
  1361. payment by money transfer, but recommend that you avoid this method of
  1362. payment because of serious weaknesses in the international banking
  1363. system.  If you pay by IMT, your bank MUST remit the funds DIRECTLY to
  1364. the National Bank of New Zealand, Dunedin North Branch, account
  1365. 060909-0106632-13. The name of the account is "David Harris, Pegasus
  1366. Mail". Please stress to your bank the importance of the direct transfer
  1367. - transfers sent to us via other banks in New Zealand will attract a
  1368. processing fee which we refuse to accept; my bank has standing orders
  1369. to reject such payments and return them to the sender. Only transfers
  1370. made directly to the National Bank of New Zealand are acceptable.
  1371. Please note that the "National Bank of New Zealand" and the "Bank of
  1372. New Zealand" are completely different institutions.
  1373. Fees and deductions
  1374. : it appears to be common practice in parts of
  1375. Europe for banks to deduct fees from the amount remitted - we will not
  1376. accept such deductions and will return payments from which fees have
  1377. been deducted unpresented. We require the amount paid to us to be the
  1378. amount shown on the invoice.
  1379. US Taxpayer information requests
  1380. : we periodically receive requests from
  1381. US companies and organizations asking us to provide "FEIN" numbers, or
  1382. Social Security Numbers which are needed by the client for compliance
  1383. with US Tax Laws. We have contacted the US Commerce Attache in Sydney,
  1384. Australia, and advise on their recommendation that the vendor is NOT a
  1385. US Citizen, and is not resident in the USA for taxation purposes. We
  1386. cannot provide the information requested (we have neither a FEIN nor an
  1387. SSN) and requests for such information will not receive a reply. We
  1388. suggest you record that the vendor is a foreign national not subject to
  1389. US taxation laws.
  1390. Quotes, bids, pro-forma invoices and acknowledgments
  1391. : because of the
  1392. sheer volume of paperwork we have to process, we regret that we are
  1393. unable to provide quotes, bids, pro-forma invoices or acknowledgments
  1394. of receipt of orders (other than by e-mail on specific request). The
  1395. most recent version of this file retrieved from us by e-mail may be
  1396. taken as a firm quote - we will honour the prices shown provided this
  1397. form is used.
  1398. VAT and import taxes
  1399. : when we ship manuals, we enclose a commercial 
  1400. invoice for customs purposes, itemized as US$11 for materials and the 
  1401. remainder of the fee as a license charge. We are not responsible for
  1402. taxes or import duties levied on entry to your country and suggest you
  1403. contact your customs service in advance for information on any fees
  1404. which might be payable.
  1405. Freight charges
  1406. : all manual prices include courier shipment via EMS 
  1407. (Express Mail Service) anywhere in the world. EMS usually provides a
  1408. four-day service to any destination. We can ship via airmail on
  1409. specific request, but are unable to ship via other carriers (such as
  1410. FedEx, UPS or DHL).
  1411. Delivery times
  1412. : the usual processing time for an order is 8-10 days plus
  1413. the time required for shipment. Occasionally the time required will be 
  1414. longer than this, and if a new version of the manual is due in the near
  1415. future, we reserve the right to hold your order until it is released, so
  1416. that you get the most up-to-date product.
  1417.        Press <F10> and choose "Edit" to fill in this order form
  1418. Please ensure you have read the "terms and conditions" section carefully.
  1419.           --------------------------------------------------
  1420.                  G E N E R A L   O R D E R   F O R M
  1421.                       for Pegasus Mail Manuals
  1422.           --------------------------------------------w122--
  1423.  Ship To:                            Bill To:
  1424. [                            ]      [                               ]
  1425. [                            ]      [                               ]
  1426. [                            ]      [                               ]
  1427. [                            ]      [                               ]
  1428. [                            ]      [                               ]
  1429. Date this order was mailed          [   ] Day  [   ] Mon  [   ] Year
  1430. What is your purchase order number  [                               ]
  1431.  or: Credit card type (tick one)    [   ] Visa [   ] Mastercard
  1432.      Card number (print carefully)  [                    ] exp: [   ]
  1433.      Name shown on card             [                               ]
  1434. Number of invoice copies required   [   ]
  1435. Manual format required (tick one)   [   ] A4   [   ] US-Letter
  1436. Internet e-mail address of contact  [                               ]
  1437. Fax number of contact               [                               ]
  1438. Please supply the following items:
  1439. --------- New Manual Licenses: --------------------------
  1440. [  ] 5-copy manual set, Pegasus Mail/DOS @US$175 . . . . US$ [       ]
  1441. [  ] 5-copy manual set, Pegasus Mail/Windows @US$175 . . US$ [       ]
  1442. [  ] 5-copy manual set, Pegasus Mail/Mac @US$150 . . . . US$ [       ]
  1443. [  ] Single manual set, Mercury System @US$150 . . . . . US$ [       ]
  1444. [  ] Site-licensed set, Pegasus Mail/DOS @US$350 . . . . US$ [       ]
  1445. [  ] Site-licensed set, Pegasus Mail/Windows @US$350 . . US$ [       ]
  1446. [  ] Site-licensed set, Pegasus Mail/Mac @US$300 . . . . US$ [       ]
  1447. [  ] Site-licensed set, Mercury System @US$300 . . . . . US$ [       ]
  1448. [  ] Site bundle, Pegasus Mail/DOS and WinPMail @US$525  US$ [       ]
  1449. [  ] Site bundle, Pegasus Mail/DOS and Mac @US$500 . . . US$ [       ]
  1450. [  ] Site bundle, Pegasus Mail/Mac and WinPMail @US$500  US$ [       ]
  1451. [  ] Site bundle, DOS, Windows & Mac @US$750 . . . . . . US$ [       ]
  1452. --------- Upgrades: -------------------------------------
  1453. Any previous DOS license to current version @US$125  . . US$ [       ]
  1454. Any previous Mac license to current version @US$125  . . US$ [       ]
  1455. Any previous Windows license to current version @US$125  US$ [       ]
  1456. Any previous Mercury license to current version @US$125  US$ [       ]
  1457. (Please quote your current license number for upgrades).
  1458. ---------- Discounts: -----------------------------------
  1459. If you order or hold a SITE license for one Pegasus Mail
  1460. platform (DOS, Win, Mac) you can claim $75 off each sub-
  1461. sequent SITE license platform purchase (EXCLUDES BUNDLES).               
  1462.                             Total discount . . . . . . . US$ [       ]
  1463. (NOTE: discounts do NOT apply if you hold a 5-copy license,
  1464. or are purchasing a 5-copy license, upgrade or site bundle)
  1465.